---
title: Harvest
sidebarTitle: Harvest
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/harvest/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/harvest/PreBuiltUseCases.mdx"

import { StatusWidget } from "/snippets/api-down-watch/status-widget.jsx"

<StatusWidget service="harvest" />

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ❓ |  |
| Paid test account | ❓ |  |
| Partnership | ❓ | |
| App review | ❓ |  |
| Security audit | ❓ | |


## Setup guide

_No setup guide yet._

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/harvest.mdx)</Note>


## Useful links

-   [OAuth-related docs](https://help.getharvest.com/api-v2/authentication-api/authentication/authentication/#oauth2-application)
-   [Register an Application](https://id.getharvest.com/oauth2/clients/new)
-   [Scopes](https://help.getharvest.com/api-v2/authentication-api/authentication/authentication/#scopes-and-account-access)
-   [Harvest REST API docs](https://help.getharvest.com/api-v2)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/harvest.mdx)</Note>

## API gotchas
- When creating a connection, you need to add the `appDetails` configuration parameter in the format `MyApp (yourname@example.com)`, which will be appended to the request as a header: `User-Agent: MyApp (yourname@example.com)`. This information will be used to get in touch if you’re doing something wrong(so the provider can warn you before you’re blocked) or something awesome (so the provider can congratulate you). Requests without a valid `User-Agent` header are rejected.
- Harvest enforces different rate limits for different endpoints. For more details check [harvest rate limits](https://help.getharvest.com/api-v2/introduction/overview/general/#rate-limiting)
<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/harvest.mdx)</Note>
